Skip to content

docs: Add some .lldbint configurations for debugging document#3686

Merged
comphead merged 1 commit intoapache:mainfrom
wForget:minor
Mar 18, 2026
Merged

docs: Add some .lldbint configurations for debugging document#3686
comphead merged 1 commit intoapache:mainfrom
wForget:minor

Conversation

@wForget
Copy link
Member

@wForget wForget commented Mar 13, 2026

Which issue does this PR close?

Closes #.

Rationale for this change

Avoid unnecessary debugger breaking

What changes are included in this PR?

Ignore some exceptions and signals on lldb debugger

How are these changes tested?

use advanced `lldb` debugging. For example, we can ignore some exceptions and signals that are not relevant
to our debugging and would otherwise cause the debugger to stop.

```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @wForget is this example or recommended .lldbinit?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tend to think it is recommended, these exceptions/signals don't seem to need to be considered during local debugging.


```
settings set platform.plugin.darwin.ignored-exceptions EXC_BAD_ACCESS|EXC_BAD_INSTRUCTION
process handle -n true -p true -s false SIGBUS SIGSEGV SIGILL
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need to pass thru SIGBUS and SIGSEGV? The -Xint option to the JVM somewhat takes care of the signals that the JVM uses internally but even then I have seen SIGILL, BAD_ACCESS and BAD_INSTRUCTION but never encountered the other two.
We have hit SIGBUS and SIGSEGV in some of the Comet unsafe code though, iirc.
To be fair though, this is meant for advanced users who know what they are doing at that low a level, so maybe it is ok to include this in the recommendations.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need to pass thru SIGBUS and SIGSEGV?

I'm not sure if I encountered it while debugging with Comet. I placed .lldbint in the USER_HOME directory and sometimes improved it while debugging Velox.

Copy link
Contributor

@parthchandra parthchandra left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved with comment

@comphead comphead merged commit a1a82fd into apache:main Mar 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants